@mount("ft4.transfer") operation transfer(recipient_id: byte_array, asset_id: byte_array, amount: big_integer)

Transfers tokens to a certain recipient.

  • if the recipient exists, a normal transfer will take place;
  • otherwise:
    • if account creation on transfer is enabled, the account registration procedure will be started;
    • an error is thrown

Must be signed by an auth descriptor with accounts.auth_flags.TRANSFER

Throws if the required assets cannot be transferred. Common cases include:

  • the sender account's balance is lower than amount
  • the amount to transfer is not in the accepted range (0, 2^256) (exclusive)
  • some conditions added in development through transfer extensions (before_transfer or after_transfer) aren't met

Parameters

  • recipient_id — the account that should receive the transfer or be created
  • asset_id — id of the asset that should be sent
  • amount — the amount to transfer
© 2024 Chromia